home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 25 / AACD 25.iso / AACD / Magazine / Online / QMail / man / cat5 / addresses.0 < prev    next >
Encoding:
Text File  |  1997-09-21  |  8.1 KB  |  265 lines
  1.  
  2.  
  3.  
  4. addresses(5)                                         addresses(5)
  5.  
  6.  
  7. NNAAMMEE
  8.        addresses - formats for Internet mail addresses
  9.  
  10. IINNTTRROODDUUCCTTIIOONN
  11.        A mmaaiill aaddddrreessss is a string of characters containing @.
  12.  
  13.        Every  mail  address  has  a llooccaall ppaarrtt and a ddoommaaiinn ppaarrtt.
  14.        The domain part is everything  after  the  final  @.   The
  15.        local part is everything before.
  16.  
  17.        For example, the mail addresses
  18.  
  19.           God@heaven.af.mil
  20.           @heaven.af.mil
  21.           @at@@heaven.af.mil
  22.  
  23.        all  have  domain part hheeaavveenn..aaff..mmiill.  The local parts are
  24.        GGoodd, empty, and @@aatt@@.
  25.  
  26.        Some domains have owners.   It  is  up  to  the  owner  of
  27.        hheeaavveenn..aaff..mmiill  to  say how mail messages will be delivered
  28.        to addresses with domain part hheeaavveenn..aaff..mmiill.
  29.  
  30.        The domain part  of  an  address  is  interpreted  without
  31.        regard to case, so
  32.  
  33.           God@heaven.af.mil
  34.           God@HEAVEN.AF.MIL
  35.           God@Heaven.AF.Mil
  36.  
  37.        all refer to the same domain.
  38.  
  39.        There  is one exceptional address that does not contain an
  40.        @: namely, the empty string.  The empty string  cannot  be
  41.        used  as  a recipient address.  It can be used as a sender
  42.        address so that the real sender doesn't receive bounces.
  43.  
  44. QQMMAAIILL EEXXTTEENNSSIIOONNSS
  45.        The qqmmaaiill system allows several further types of addresses
  46.        in mail envelopes.
  47.  
  48.        First,  an  envelope  recipient  address  without  an @ is
  49.        interpreted as being  at  _e_n_v_n_o_a_t_h_o_s_t.   For  example,  if
  50.        _e_n_v_n_o_a_t_h_o_s_t  is  hheeaavveenn..aaff..mmiill,  the  address  GGoodd will be
  51.        rewritten as GGoodd@@hheeaavveenn..aaff..mmiill.
  52.  
  53.        Second, the address ##@@[[]] is used  as  an  envelope  sender
  54.        address for double bounces.
  55.  
  56.        Third,  envelope sender addresses of the form _p_r_e@@_h_o_s_t--@@[[]]
  57.        are  used  to  support  variable  envelope  return   paths
  58.        (VERPs).   qqmmaaiill--sseenndd  will rewrite _p_r_e@@_h_o_s_t--@@[[]] as _p_r_e_r_e_-
  59.        _c_i_p==_d_o_m_a_i_n@@_h_o_s_t for deliveries to  _r_e_c_i_p@@_d_o_m_a_i_n.   Bounces
  60.        directly from qqmmaaiill--sseenndd will come back to _p_r_e@@_h_o_s_t.
  61.  
  62.  
  63.  
  64.                                                                 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. addresses(5)                                         addresses(5)
  71.  
  72.  
  73. CCHHOOOOSSIINNGG MMAAIILL AADDDDRREESSSSEESS
  74.        Here  are  some suggestions on choosing mail addresses for
  75.        the Internet.
  76.  
  77.        Do not use non-ASCII characters.  Under RFC  822  and  RFC
  78.        821, these characters cannot be used in mail headers or in
  79.        SMTP commands.  In practice, they are regularly corrupted.
  80.  
  81.        Do  not  use  ASCII  control characters.  NUL is regularly
  82.        corrupted.  CR and LF cannot be used in some  combinations
  83.        and  are  corrupted  in all.  None of these characters are
  84.        usable on business cards.
  85.  
  86.        Avoid spaces and the characters
  87.  
  88.           \"<>()[],;:
  89.  
  90.        These all require quoting in mail  headers  and  in  SMTP.
  91.        Many  existing  mail  programs do not handle quoting prop-
  92.        erly.
  93.  
  94.        Do not use @ in a local part.  @ requires quoting in  mail
  95.        headers  and  in SMTP.  Many programs incorrectly look for
  96.        the first @, rather than the last @, to  find  the  domain
  97.        part of an address.
  98.  
  99.        In a local part, do not use two consecutive dots, a dot at
  100.        the beginning, or a dot at the end.  Any  of  these  would
  101.        require quoting in mail headers.
  102.  
  103.        Do  not  use an empty local part; it cannot appear in SMTP
  104.        commands.
  105.  
  106.        Avoid local parts longer than 64 characters.
  107.  
  108.        Be wary of uppercase letters in local  parts.   Some  mail
  109.        programs    (and    users!)   will   incorrectly   convert
  110.        GGoodd@@hheeaavveenn..aaff..mmiill to ggoodd@@hheeaavveenn..aaff..mmiill.
  111.  
  112.        Be wary of the following characters:
  113.  
  114.           $&!#~`'^*|{}
  115.  
  116.        Some users will not know  how  to  feed  these  characters
  117.        safely to their mail programs.
  118.  
  119.        In  domain names, stick to letters, digits, dash, and dot.
  120.        One popular DNS resolver has, under the  banner  of  secu-
  121.        rity,  recently begun destroying domain names that contain
  122.        certain other characters,  including  underscore.   Excep-
  123.        tion:  A  dotted-decimal  IP  address in brackets, such as
  124.        [[112277..00..00..11]], identifies a domain owned by whoever owns the
  125.        host at that IP address, and can be used safely.
  126.  
  127.  
  128.  
  129.  
  130.                                                                 2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. addresses(5)                                         addresses(5)
  137.  
  138.  
  139.        In  a  domain name, do not use two consecutive dots, a dot
  140.        at the beginning, or a dot at the end.  This  means  that,
  141.        when  a  domain  name is broken down into components sepa-
  142.        rated by dots, there are no empty components.
  143.  
  144.        Always use at least one dot in a domain name.  If you  own
  145.        the  mmiill  domain, don't bother using the address rroooott@@mmiill;
  146.        most users  will  be  unable  to  send  messages  to  that
  147.        address.  Same for the root domain.
  148.  
  149.        Avoid domain names longer than 64 characters.
  150.  
  151. EENNCCOODDEEDD AADDDDRREESSSSEESS IINN SSMMTTPP CCOOMMMMAANNDDSS
  152.        RFC  821  defines  an  encoding of mail addresses in SMTP.
  153.        For example, the addresses
  154.  
  155.           God@heaven.af.mil
  156.           a"quote@heaven.af.mil
  157.           The Almighty.One@heaven.af.mil
  158.  
  159.        could be encoded in RCPT commands as
  160.  
  161.           RCPT TO:<God@heaven.af.mil>
  162.           RCPT TO:<a\"quote@heaven.af.mil>
  163.           RCPT TO:<The\ Almighty.One@heaven.af.mil>
  164.  
  165.        There are several restrictions in  RFC  821  on  the  mail
  166.        addresses  that  can be used over SMTP.  Non-ASCII charac-
  167.        ters are prohibited.  The local part must  not  be  empty.
  168.        The  domain  part must be a sequence of elements separated
  169.        by dots, where each  element  is  either  a  component,  a
  170.        sequence  of  digits preceded by #, or a dotted-decimal IP
  171.        address surrounded by brackets.  The only allowable  char-
  172.        acters  in  components  are  letters,  digits, and dashes.
  173.        Every component must (believe it or  not)  have  at  least
  174.        three  characters;  the  first character must be a letter;
  175.        the last character must not be a hyphen.
  176.  
  177. EENNCCOODDEEDD AADDDDRREESSSSEESS IINN MMAAIILL HHEEAADDEERRSS
  178.        RFC 822 defines an encoding of mail addresses  in  certain
  179.        header  fields  in  a  mail  message.   For  example,  the
  180.        addresses
  181.  
  182.           God@heaven.af.mil
  183.           a"quote@heaven.af.mil
  184.           The Almighty.One@heaven.af.mil
  185.  
  186.        could be encoded in a TToo field as
  187.  
  188.           To: God@heaven.af.mil,
  189.             <@brl.mil:"a\"quote"@heaven.af.mil>,
  190.               "The Almighty".One@heaven.af.mil
  191.  
  192.        or perhaps
  193.  
  194.  
  195.  
  196.                                                                 3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. addresses(5)                                         addresses(5)
  203.  
  204.  
  205.           To: < "God"@heaven .af.mil>,
  206.             "a\"quote" (Who?) @ heaven . af.  mil
  207.             , God<"The Almighty.One"@heaven.af.mil>
  208.  
  209.        There are several restrictions on the mail addresses  that
  210.        can  be used in these header fields.  Non-ASCII characters
  211.        are prohibited.  The domain part must  be  a  sequence  of
  212.        elements  separated by dots, where each element either (1)
  213.        begins with [ and ends with ] or (2) is a nonempty  string
  214.        of printable ASCII characters not including any of
  215.  
  216.           \".<>()[],;:
  217.  
  218.        and not including space.
  219.  
  220. SSEEEE AALLSSOO
  221.        envelopes(5),   qmail-header(5),  qmail-inject(8),  qmail-
  222.        remote(8), qmail-smtpd(8)
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                                                                 4
  263.  
  264.  
  265.